home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 July / EnigmA AMIGA RUN 20 (1997)(G.R. Edizioni)(IT)[!][issue 1997-07 & 08][EAR-CD IV].iso / recent1 / wwwcount2.3src.lha / wwwcount2.3 / AMIGA INSTALL next >
Text File  |  1997-05-16  |  7KB  |  237 lines
  1.              WWWCOUNTER 2.3 (C) 1996 by Muhammad A. Muquit 
  2.                  Ported for the Amiga by Bert Vortman.
  3.                      **** SOURCE DISTRIBUTION ****
  4.  
  5. Copyright:
  6.  
  7. Copyright 1995-1996 by Muhammad A Muquit. Permission to use, copy, modify
  8. and sell this program for any purpose is hereby granted without fee,
  9. provided that this copyright notice appear in all copies and that both that
  10. copyright notice and this permission notice appear in supporting
  11. documentation.  If the program is included in a book, publication or in a
  12. software distribution media for sale, the author must be notified about it.
  13. No binary only distribution is allowed. All distributions must include the
  14. source and this copyright notice.
  15.  
  16. THIS PROGRAM IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY.
  17. THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
  18. ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL THE
  19. AUTHOR Muhammad A. Muquit BE LIABLE FOR ANY SPECIAL, INDIRECT OR
  20. CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
  21. DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  22. TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  23. PERFORMANCE OF THIS SOFTWARE.
  24.  
  25. For questions about the program, mail to:
  26.  
  27. ma_muquit@fccc.edu
  28.  
  29. For questions about the Amiga Port:
  30.  
  31. albertv@spinnewiel.xs4all.nl
  32.  
  33.  
  34. AMIGA INSTALL
  35. -------------
  36.  
  37. Installation of the WWWCounter is almost exactly the same as the 
  38. unix version of the wwwcounter. You only need to change the
  39. count-install script. 
  40.  
  41. REQUIREMENTS
  42. ------------
  43.  
  44. - Full GCC installation. You can obtain GCC from: 
  45.  
  46.     http://www.ninemoons.com
  47.  
  48. - static IP address
  49.  
  50. - Apache :
  51.  
  52.         http://www.dsdelft.nl/~apache
  53.  
  54.   or
  55.   
  56.   AWS    :
  57.  
  58.         http://www.omnipresence.com
  59.  
  60. - Unixdirs3.lha from Aminet in util/boot.
  61.  
  62. - executehack.lha from Aminet in util/boot
  63.  
  64.  
  65. STEPS TO COMPILE AND INSTALL
  66. ----------------------------
  67.  
  68. In the current release of the counter, there should not be any need for
  69. hand editing any files except for the Count-install script. Several 
  70. configuration scripts are supplied to automate the whole process. 
  71. I am giving a little description about the scripts in case you 
  72. you are curious:
  73.  
  74. * Count-config
  75.  
  76.   script to generate the header file config.h, a variable
  77.   template file for install program.
  78.  
  79. * configure
  80.  
  81.   script to generate correct Makefiles for the Amiga
  82.  
  83. * Gen-conf
  84.  
  85.   script to generate the configuration file.
  86.  
  87. * Count-install
  88.  
  89.   script to install the Count binary Count.cgi, digit images, configuration
  90.   file and the rgb color name database to the correct places.
  91.  
  92.  
  93. STEP 1
  94. ======
  95.  
  96. Running Apache:
  97. ---------------
  98.  
  99. If you are running apache, do nothing. Just make sure that you run 
  100. the wwwcounter as the user/group which runs the httpd. Make sure
  101. that all files after installing run under this user/group 
  102. (especially in the data directory)
  103.  
  104.  
  105. Running AWS:
  106. ------------
  107.  
  108. Add a user & group to Miami or Amitcp, something like: 
  109.  
  110.     user : httpuser
  111.     group: daemon
  112.  
  113. Make sure that you have installed the fileutils-3.15-bin.lha
  114. from www.ninemoons.com. You need especially the chmod and
  115. chown program. It is strange for Amiga users to use these
  116. chmod and chown programs but it is necessary, otherwise the 
  117. wwwcounter won't run. Make also sure that all
  118. files (after compilation & installing) have the same
  119. owner & group ownership as the ones you just added to the 
  120. users of your server. 
  121.  
  122. STEP 2
  123. ======
  124.  
  125. If you have installed the executehack.lha: (you can find it on
  126. Aminet)
  127.  
  128. Set at a shell prompt the script bits of these files:
  129.  
  130. > protect configure RWEDS
  131. > protect count-config RWEDS
  132. > protect gen-conf RWEDS
  133. > protect count-install RWEDS
  134.  
  135. If you have no executehack.lha installed, run the next 
  136. commands as: sh 'scriptname'
  137.  
  138.  
  139.  
  140. STEP 3
  141. ======
  142.  
  143. Now at the shell prompt, type the following commands in the described 
  144. order and press Return.
  145.  
  146. key:
  147.  
  148.  
  149. > ./Count-config
  150.  
  151.   The script will ask questions with brief description. Answer them.
  152.   Look at the directory structure image to better understand the questions.
  153.  
  154. > ./configure
  155.  
  156.   The script will not ask any questions, but you will see the informational 
  157.   messages about your system. It will create the Makefiles Makefile,
  158.   combine/Makefile and utils/Makefile for your system. It's maybe wise 
  159.   to set the source directory in the 'srcdir=' variabele. 
  160.  
  161. > make clean
  162.  
  163.   (not needed if you are compiling the first time)
  164.  
  165. > make
  166.  
  167.   Compilation will start if the previous two scripts completed successfully.
  168.   It will take some time. If compilation succeeds, go to the next step.
  169.  
  170. > ./Gen-conf
  171.  
  172.   This script will ask you questions about your system. Answer them.
  173.   This process will create the configuration file for the counter. 
  174.  
  175. >./Count-install
  176.  
  177. This is the final step. This scripts will install the necessary things
  178. for the counter in your system.
  179.  
  180. Change the following line in the Count-install script:
  181.  
  182. INSTALL_PROG="./install-sh" in: INSTALL_PROG="/bin/install"
  183.  
  184. Ignore the message about root access, unless you're running MUFS!
  185. This program will ask you some questions.
  186.  
  187. If you finished all the above steps successfully, you are ready to test
  188. the counter. 
  189.  
  190. STEP 4
  191. ======
  192.  
  193. Test the program from your browser. So, copy the countexample.html file in
  194. the public directory to a place where you want it, startup Apache or AWS,
  195. start your browser and type:
  196.  
  197. http:///countexample.html (or where ever you put it)
  198.  
  199. This is how it looks like:
  200.  
  201. <img src="/cgi-bin/Count.cgi?df=sample.dat" align=absmiddle> 
  202. A counter example 
  203. <img src="/cgi-bin/Count.cgi?display=clock" align=absmiddle>
  204.  
  205. The string between ? and " is called the QUERY_STRING. Make sure there is
  206. no newlines in the img src= line and no space in the QUERY_STRING. 
  207. Here in, df=sample.dat, df means datafile and sample.dat is the counter 
  208. datafile. The counter stores the hits in this file. This datafile is supplied. 
  209. If you configured the counter to allow automatic datafile creation (look at
  210. count.cfg file), you can specify a datafile with df like
  211. df=count.dat. The file count.dat will be created for you if the 
  212. permission to the data directory is correct. 
  213.  
  214. If you configured not to allow automatic datafile creation (good thing), 
  215. you have to create this file in the data directory.
  216. Start your texteditor, type: 0 and save it as:
  217.  
  218. count.dat
  219.  
  220. in the data directory. And chown to the user & group of the wwwcounter. ie: 
  221.  
  222.        chown user:group count.dat
  223.        chmod 664 count.dat
  224.  
  225. The counter program has lots of options, you can make it work and look the
  226. way you desire. In the query string, you can use the options described
  227. in the docs/Count.html file.
  228.  
  229. If you have any questions about compiling the wwwcounter mail to:
  230.  
  231. albertv@spinnewiel.xs4all.nl
  232.  
  233. All options of the Unix version are available in the Amiga version.
  234.  
  235. happy html'ing,
  236.  
  237. Bert Vortman